home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / pc / PWAFDS10.ZIP / SHRINKER.DOX < prev    next >
Encoding:
Text File  |  1995-06-12  |  4.9 KB  |  93 lines
  1. ───────────────────────────────────────────────────────────────────────────────
  2.  
  3.                      PCBOARD FILE DIRECTORIES SHRINKER V1.0
  4.  
  5. ───────────────────────────────────────────────────────────────────────────────
  6.                                                                 -Dox By Timecop
  7.  
  8. 1. Introduction.
  9.    ~~~~~~~~~~~~
  10.    First of all I would like to thank The Comanche, who gave me this great
  11.    idea.  At first I didn't know exactly which way I wanted to go.  I was
  12.    going to make it half EXE half PPE where you (sysop) would flag all files
  13.    that you want to be shrinked in PPE and then shell out to DOS and do all
  14.    the work.  That seemed a little retarded and it would have taken a lot more
  15.    time.
  16.  
  17. 2. A few words about the utility itself.
  18.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  19.    This utility was written in Pascal and compiled with Turbo Pascal 7.0.  The
  20.    purpose of it is to take out all the unnecessary descriptions from your file
  21.    directories.  I believe that there was another thing like this released in
  22.    1994 by Q-TIP.  There, you had to specify how many characters of a filename
  23.    to compare with others when you are running it.  I think that it's the
  24.    *worst* method.
  25.  
  26. 3. How does it work?
  27.    ~~~~~~~~~~~~~~~~
  28.    Basically I don't have to explain this but I figured that some of you will
  29.    have trouble using it (if you will, you are retarded).
  30.    There are 4 stages:
  31.    1) Going through original file collecting filenames.
  32.    2) Putting collected files in alphabetical order (was a bitch to figure out)
  33.    3) Going once again through original file, this time collecting positions
  34.       of filenames and description's sizes (in the order of previously sorted
  35.       files) for future seeking.
  36.    4) Finaly, seeking through the original file (from stage 3 we know where
  37.       files are), compare them by taking an ASCII value of each character in
  38.       filename, and write out descriptions according to ASCII values.
  39.    Need anything more to say?  If you want to know more, think harder.
  40.  
  41. 4. What happens during process?
  42.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  43.    First of all you must enter the parameter correctly.
  44.    For example: SHRINKER /C:\PCB\MAIN\PUBLIC
  45.    If you have the utility in the same directory where your directory is, you
  46.    don't have to write out the path.
  47.    Now that parameter is correct, it will rename your original directory to
  48.    .BAK and your final output will be your original directory. (the .BAK will
  49.    be saved)
  50.    Now I'd like to talk a little bit about the speed of the program.  If I were
  51.    to define the factors that affect the runtime speed I would say the
  52.    following.  Out of 100% I would give 70% to the number of files in
  53.    directory, 20% to the seeking speed of you HD, 10% to the CPU speed.  Of
  54.    course the environment also matters.  So far I tested it under DOS, DESQView
  55.    and OS/2.  It seems to be working fine under those three.
  56.  
  57. 5. Known bugs and problems.
  58.    ~~~~~~~~~~~~~~~~~~~~~~~
  59.    Unfortionately, I had to make a very bad limitation.  It didn't have to do
  60.    anything with me, it had something to do with Turbo Pascal compiler itself.
  61.    See, since I'm working with strings here, and they take up a lot of memory
  62.    the maximum possible number of 12-byte files that the program can read at
  63.    one time turned out to be 4600 (don't forget that the maximum size of any
  64.    global or local variables allowed by compiler is only 64k).  Just try to
  65.    multiply 4600 by 12.  You'll come up with 55200.  Now add to that some
  66.    necessary global variables and units that I had to add, plus I had to leave
  67.    some space to avoid any possible memory fuckups.  I tried working with
  68.    linked lists, but they gave me a headache so I said fuck it.  I think that
  69.    4600 is quite a lot and I sincerely doubt that you'll ever reach that number
  70.    no matter how fast your board is.  You don't have to worry about how many
  71.    files are in your directory, once program detects that there are more than
  72.    4600, it will stop execution automatically with a message.  Sometimes the
  73.    program might shrink an extra file or two, or leave something.  I'm not
  74.    going to get into details here explaining why that happens.  Besides don't
  75.    forget that it's a program and it doesn't have a human brain in it, so just
  76.    chill.  Watch out if you have a little header on top of your directory.
  77.    Although the program handles it, I don't guarantee anything.  Always make
  78.    sure that there are no extraneous lines or characters in your directory.
  79.  
  80. 6. Last words.
  81.    ~~~~~~~~~~
  82.    Make sure that the size of SHRINKER.EXE is 22304 bytes.  If it's not, know
  83.    that you have either cracked, or infected copy.
  84.    Oh, and I think I'll rewrite it in C to get rid of all those limitations.
  85.  
  86. 7. Greetings.
  87.    ~~~~~~~~~
  88.    Lone Runner - Of course our PPE section is alive you retard!
  89.    Drew - I think I'll call the other one CHOPPER ;)
  90.  
  91.  
  92.                                  END OF DOX
  93.